<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>IBM Visualization Data Explorer Programmer&#39;s Reference</TITLE>

<META HTTP-EQUIV="abstract" CONTENT="IBM Visualization Data Explorer
Programmer&#39;s Reference">
<META HTTP-EQUIV="contact" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="owner" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="updated" CONTENT="Tue, 16 Sep 1997 ">
<META HTTP-EQUIV="review" CONTENT="Fri, 14 Aug 1998 ">

<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF">

<A NAME="Top_Of_Page"></A>
<H1>IBM Visualization Data Explorer Programmer&#39;s Reference</H1>
<B>&#91; <A HREF="#Bot_Of_Page">Bottom of Page</A> &#124; <A
HREF="progu101.htm">Previous Page</A> &#124; <A HREF="progu103.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B><HR><P>
<H3><A NAME="HDRDXALS" HREF="progu097.htm#PToC_196">DXAddLine, ...Triangle,
...Quad, ...Tetrahedron, ...Lines, ...Triangles, ...Quads,
...Tetrahedra</A></H3>
<A NAME="IDX1488"></A>
<A NAME="IDX1489"></A>
<A NAME="IDX1490"></A>
<A NAME="IDX1491"></A>
<A NAME="IDX1492"></A>
<A NAME="IDX1493"></A>
<A NAME="IDX1494"></A>
<A NAME="IDX1495"></A>
<A NAME="IDX1496"></A>
<A NAME="IDX1497"></A>
<A NAME="IDX1498"></A>
<A NAME="IDX1499"></A>
<A NAME="IDX1500"></A>
<A NAME="IDX1501"></A>
<A NAME="IDX1502"></A>
<A NAME="IDX1503"></A>
<P><STRONG>Function</STRONG>
Adds interpolation element(s) to a Field.
<P><STRONG>Syntax</STRONG>
<PRE><STRONG>
&#35;include &lt;dx/dx.h&gt;
Field DXAddLine(Field f, int id, Line l)
Field DXAddTriangle(Field f, int id, Triangle t)
Field DXAddQuad(Field f, int id, Quadrilateral q)
Field DXAddTetrahedron(Field f, int id, Tetrahedron t)
Field DXAddLines(Field f, int start, int n, Line *l)
Field DXAddTriangles(Field f, int start, int n, Triangle *t)
Field DXAddQuads(Field f, int start, int n, Quadrilateral *q)
Field DXAddTetrahedra(Field f, int start, int n, Tetrahedron *t)
</STRONG>
</PRE>.
<P><STRONG>Functional Details</STRONG>
The interpolation elements generated by these routines are stored in
the "connections" component.
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><B><TT><STRONG>DXAddLine&nbsp;,&nbsp;
DXAddTriangle&nbsp;,&nbsp;
DXAddQuad&nbsp;,&nbsp; DXAddTetrahedron</STRONG></TT>
</B></TD><TD><P>Add a single line, triangle, quad, or tetrahedron to
<TT><STRONG>f</STRONG></TT> with the specified zero-based
<TT><STRONG>id</STRONG></TT>.
If necessary, a routine creates the "connections" component.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>DXAddLines&nbsp;,&nbsp;
DXAddTriangles&nbsp;,&nbsp;
DXAddQuads&nbsp;,&nbsp; DXAddTetrahedra</STRONG></TT>
</B></TD><TD><P>Add <TT><STRONG>n</STRONG></TT> lines, triangles, quads, or
tetrahedra
to <TT><STRONG>f</STRONG></TT>.
Identifiers begin with <TT><STRONG>start</STRONG></TT>.
If necessary, a routine creates the "connections" component.
</TD></TR></TABLE>
<P>
<TT><STRONG>Lines&nbsp;,&nbsp; Triangles&nbsp;,&nbsp;
Quadrilaterals&nbsp;,&nbsp; and Tetrahedra.</STRONG></TT> are
defined as follows:
<PRE>
<STRONG>
typedef struct line {
    PointId p, q;
} Line;
typedef struct triangle {
    PointId p, q, r;
} Triangle;
typedef struct quadrilateral {
    PointId p, q, r, s;
} Quadrilateral;
typedef struct tetrahedron {
    PointId p, q, r, s;
} Tetrahedron;
</STRONG>
</PRE>
<P><B>Note: </B>It is an error to attempt adding one kind of interpolation
element
to a "connections" component that already contains a
different kind.
<P><STRONG>Return Value</STRONG>
Returns <TT><STRONG>f</STRONG></TT> or returns <TT><STRONG>NULL</STRONG></TT>
and sets an error code.
<P><STRONG>See Also</STRONG>
<TT><STRONG>
<A HREF="progu308.htm#HDRDXSC">DXSetConnections</A>,
<A HREF="progu164.htm#HDRDXGC">DXGetConnections</A>
</STRONG></TT>
<P>
<A HREF="progu050.htm#HDRCNN">"Connections"</A>.
<P><HR><B>&#91; <A HREF="#Top_Of_Page">Top of Page</A> &#124; <A
HREF="progu101.htm">Previous Page</A> &#124; <A HREF="progu103.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B> <br><b>&#91;<a
href="../allguide.htm">Data Explorer Documentation</a>&nbsp;&#124;&nbsp;<a
href="../qikguide.htm">QuickStart Guide</a>&nbsp;&#124;&nbsp;<a
href="../usrguide.htm">User&#39;s Guide</a>&nbsp;&#124;&nbsp;<a
href="../refguide.htm">User&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../proguide.htm">Programmer&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../insguide.htm">Installation and Configuration
Guide</a>&nbsp;&#93;</b><br><p><b>&#91;<a
href="http://www.research.ibm.com/dx">Data Explorer Home
Page</a>&#93;</b><p><HR ALIGN=LEFT WIDTH=600><b>&#91;<A
HREF="http://www.ibm.com/">IBM Home Page</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Orders/">Order</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Search/">Search</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Assist/">Contact IBM</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Legal/">Legal</A>&nbsp;&#93;</b><hr><p>
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
